package com.witmore.neutron.ai.cognitive.service;

import java.util.concurrent.TimeUnit;

/**
 * 分布式锁接口
 * Author: 豆子高
 * Date: 2025/1/15
 */
public interface DistributedLock {

    /**
     * 尝试获取锁
     * 
     * @param lockKey 锁的键
     * @param timeout 超时时间
     * @param unit 时间单位
     * @return 是否获取成功
     */
    boolean tryLock(String lockKey, long timeout, TimeUnit unit);

    /**
     * 尝试获取锁，带有等待时间
     * 
     * @param lockKey 锁的键
     * @param waitTime 等待时间
     * @param leaseTime 锁持有时间
     * @param unit 时间单位
     * @return 是否获取成功
     */
    boolean tryLock(String lockKey, long waitTime, long leaseTime, TimeUnit unit);

    /**
     * 释放锁
     * 
     * @param lockKey 锁的键
     */
    void unlock(String lockKey);

    /**
     * 执行带锁的操作
     * 
     * @param lockKey 锁的键
     * @param waitTime 等待时间
     * @param leaseTime 锁持有时间
     * @param unit 时间单位
     * @param task 要执行的任务
     * @param <T> 返回值类型
     * @return 执行结果
     * @throws Exception 执行异常
     */
    <T> T executeWithLock(String lockKey, long waitTime, long leaseTime, TimeUnit unit, LockTask<T> task) throws Exception;

    /**
     * 锁任务接口
     * 
     * @param <T> 返回值类型
     */
    @FunctionalInterface
    interface LockTask<T> {
        T execute() throws Exception;
    }
}